home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 April / EnigmA AMIGA RUN 17 (1997)(G.R. Edizioni)(IT)[!][issue 1997-04][EAR-CD].iso / EARCD / dev / amos / Ercole_ext.lha / Ercole_ext.readme < prev    next >
Text File  |  1996-12-03  |  5KB  |  160 lines
  1. Short:    AMOS & AMOSPro Extension V1.7
  2. Uploader: ercole@usa.net (Ercole Spiteri)
  3. Author:   ercole@usa.net (Ercole Spiteri)
  4. Type:     dev/amos
  5. Replaces: dev/amos/Ercole_ext.lha
  6.  
  7. Ercole.Lib AMOS Extension V1.6 & AMOSPro_Ercole.Lib V1.7
  8. --------------------------------------------------------
  9.  
  10. Introduction
  11. ~~~~~~~~~~~~
  12. This is an AMOS extension which provides 10 new commands to AMOS basic and Compiler.
  13. The commands provide the possibility for game programmers to utilise the game ports
  14. of the Amiga to their best, thus making the creation of multiplayer games with AMOS
  15. easier. There are commands for the 3rd and 4th Joysticks using the parallel 4 port
  16. player addaptor, commands for the 2nd and 3rd buttons available on games consoles
  17. joysticks and finally there is also support for paddles or analog joysticks. Also
  18. included are commands which give access to Cli and external libraries.
  19.  
  20. FreeWare
  21. ~~~~~~~~
  22. This program is freeware, ie, you can copy it and distribute it as much as you like
  23. provided the archive is kept intact. If you use the program a lot then please send
  24. me an E-Mail to let me know that you found the program usefull.
  25.  
  26. New Commands
  27. ~~~~~~~~~~~~
  28. This extension adds the following commands to AMOS:
  29.  
  30. System Commands:
  31. ---------------
  32.  
  33. Cli <string>,<integer>,<string>                  Function: Calls Cli cammands from AMOS
  34.        A         B         C
  35.  
  36. where; A=Cli command line eg List DF0:
  37.        B=Input File handle if needed else place a 0
  38.        C=Filename where Output of command will be redirected to.
  39.  
  40.  
  41.  
  42. <integer>=Library Open (<string>)                Function: Opens any Amiga Library
  43.     A                      B
  44.  
  45. where; A=Integer where address of library opened will be placed. Functions of the library
  46.          can be called by using the Call command eg Call A-30 (for first function).
  47.        B=Library name eg dos.library
  48.  
  49.  
  50.  
  51. Library Close <integer>                          Function: Closes opened Libraries
  52.                   A
  53.  
  54. where; A=result of Library Open function
  55.  
  56.  
  57. Gameports Commands:
  58. ------------------
  59.  
  60. The following 2 commands allow access to joysticks 3 and 4. These can be attached to an
  61. Amiga using the parallel port 4 player adapter lead.
  62.  
  63. <integer>=Ext Joy(<integer>)                     Funtion: Check direction of joystick
  64.     A                 B
  65.  
  66. where; A=Number given reflects direction of joystick
  67.        B=0 for 3rd joystick and 1 for 4th joystick
  68.  
  69.  
  70.  
  71. <integer>=Ext Fire(<integer>)                    Function: Check if fire button pressed
  72.     A                  B
  73.  
  74. where; A=-1 if button pressed else 0
  75.        B=0 for 3rd joystick and 1 for 4th joystick
  76.  
  77.  
  78. The following 2 commands allow access to the 2nd and 3rd fire bottons of Joysticks 1 and 2
  79. if available.
  80.  
  81. <integer>=Xfire(<integer>)                       Function: Check if 2nd button is pressed
  82.     A               B
  83.  
  84. where; A=-1 if button pressed else 0
  85.        B=0 for 1st joystick and 1 for 2nd joystick
  86.  
  87.  
  88. <integer>=Yfire(<integer>)                       Function: Check if 3rd button is pressed
  89.     A               B
  90.  
  91. where; A=-1 if button pressed else 0
  92.        B=0 for 1st joystick and 1 for 2nd joystick
  93.  
  94.  
  95. The following 4 commands deal with paddles attached to ports 1 and 2. They can also be
  96. used to read analog joysticks.
  97.  
  98. Prop On                                          Function: Starts Paddles testing
  99.  
  100.  
  101.  
  102. Prop Off                                         Function: Stops Paddles testing
  103.  
  104.  
  105.  
  106. <integer>=Paddle(<integer>)                      Function: Read Paddle potentiometer
  107.     A                B
  108.  
  109. where; A=Potentiometer reading (1-255)
  110.        B=Paddle number (0-3)
  111.  
  112.  
  113.  
  114. <integer>=Pad Fire(<integer>)                    Function: Check Fire Buttons of Paddles
  115.     A                  B
  116.  
  117. where; A=-1 if button pressed else 0
  118.        B=Paddle number (0-3)
  119.  
  120. Known bugs:
  121. ----------
  122.  
  123. Due to a bug in Amos, paddles 0 and 1 and an analog joystick in port 0 will not work. This is
  124. since port 0 is the mouse port and AMOS basic continually writes to the registers of port 0 to
  125. be able to read the mouse right and middle buttons.This affects the potentiometer readings of port 0 
  126. which would have worked perfectly where it not for this reason. If in the future AMOS would have a 
  127. command which stops the mouse right and middle buttons checking then this bug would be fixed. Thus I 
  128. did not disable checking of paddles and analog joysticks on port 0 in the hope that the writer of AMOS 
  129. will in the future provide a command which disables the checking of these mouse buttons.
  130.  
  131. Installation:
  132. ~~~~~~~~~~~~
  133. Place the Ercole.Lib file in your AMOS_System drawer and add this line in your Extension list:
  134.  
  135. AMOS_System/Ercole.Lib
  136.  
  137. Place this extension as extension 10 otherwise it won`t work, if you have another extension which
  138. needs extension 10 to work then tell me and I will make a special version for your system.
  139.  
  140. What`s New:
  141. ~~~~~~~~~~
  142. Extension now works with AMOS Pro. A new file called AMOSPro_Ercole.Lib is included in the
  143. archive which should be used instead of Ercole.Lib for AMOS Pro.
  144.  
  145. Contacts:
  146. ~~~~~~~~
  147. You can contact the Author of this extension by:
  148.  
  149.  Snail Mail: Ercole Spiteri
  150.              `Villa Loreto`, Bishop Buttigieg Street,
  151.              Qala,
  152.              Gozo, Malta, Europe.
  153.              GSM 103
  154.  
  155.  E-Mail: ercole@maltanet.omnes.net (Not Valid after end of 1996)
  156.          ercole@usa.net
  157.  Voice Phone: +(356) 554929
  158.  BBS Phone: +(356) 564184
  159.  
  160.